
This readme provides some hints how to run Voicebot Suite in Oracle Virtual Box

1) The network can be pre-set in a bridge mode or a NAT mode:

  NAT node (network address translation) - the virtual machine is hidden behind your host IP (the machine that runs
  VirtualBox). A new IP address space is created. There is an address translation between the host IP and 
  the new address space. As your host machine is already registered in your computer networks, there probably 
  will not be any difficulties accessing the network from the virtual machine.

  bridge mode - the virtual machine is registered to the same computer network as the host (the machine that runs VirtualBox).
  The DHCP server is asked for an IP address. There may be some restrictions in your network, and therefore the help of
  a computer network administrator may be necessary. Your network can check the MAC address, and there may be the IEEE 802.1x
  authentification etc.

  Pre-set the network mode in the VirtualBox GUI, right-click to the virtual machine name, settings, network,
  advanced, connected to.

2) if the NAT mode is selected, you should take care of the following steps:

  a) the used IP addressed behind NAT should be from a private space 192.168.x.x. This command can change the IP
  range from default 10.0.x.x to a new one. If you use an address from a public space, Twilio may try to send packets 
  to the computer directly. An explicit setting of an external IP address may be necessary for the Asterisk configuration 
  then.

    VBoxManage modifyvm ubuntu --natnet1 "192.168.2/24"

  b) be sure that the NAT uses the same NAT port for the combination of source IP/port, target IP/port. This is 
  necessary to be able to receive packets originated from Twillio. These packets are coming from the IP/port that 
  received the SIP register message before. By default, VirtualBox generates a new/random NAT port for each session. The 
  behavior can be changed by the following commands.

    VBoxManage modifyvm ubuntu --nataliasmode1 proxyonly
    VBoxManage modifyvm ubuntu --nataliasmode1 sameports


  All these changes can be done by the scripts/virtualbox.bat script under Windows.

